home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / 172bdoc.zip / 172B.DOC next >
Text File  |  1989-08-06  |  16KB  |  377 lines
  1. Supplemental Documentation for RBBS-PC 17.2B/0806
  2. By Ken Goosens, Fairfax, Virginia, September 6, 1989
  3.  
  4. Contents
  5.  
  6. 1.0  What's New in 17.2B/0806
  7. 2.0  Acknowledgments
  8. 3.0  What Does "Maintenance Release" Mean?
  9. 4.0  How to Upgrade from 17.2A
  10. 5.0  How to Get Help with RBBS
  11. 6.0  The RBBS Committment
  12.  
  13.  
  14. 1.0  What's New in 17.2B/0806
  15.  
  16. Version 17.2B/0806 is a "maintenance release" for 17.2A, with over
  17. 60 changes to 17.2A.   A summary, plus details with code fragments,
  18. are found in RBBS-MRG.ZIP.   Most of the fixes are minor, but the
  19. major ones are
  20.  
  21. o   time remaining when back from a door is now always right
  22.  
  23. o   the command to execute a macro inside a questionnaire now works
  24.  
  25. o   occasional constant recycling has been eliminated
  26.  
  27. o   diverse bugs on macro processing have been fixed, and macros
  28.     can now be limited to a section or particular command
  29.  
  30. o   questionnaire chaining now works right.
  31.  
  32. The files that are different in 17.2B are:
  33.  
  34. RBBS-EXE.ZIP - Executables programs CONFIG.EXE and RBBS-PC.EXE
  35. RBBSSEXE.ZIP - Smaller and faster version of RBBS-PC.EXE
  36. RBBS-BAS.ZIP - Basic source code
  37. RBBS-LIT.ZIP - Merges to produce to code with smallest size, by
  38.                giving sysop option to remove unused features.
  39. RBBS-MRG.ZIP - Merges to 17.2A to produce 17.2B source code, as well
  40.                as details on changes.
  41. RBBS-TXT.ZIP - System text files.  Only HELP0x files changed.
  42.  
  43. Note:  17.2B/0806 fixes some problems in 17.2B.   The changes from 17.2B
  44. are:  correction to SMARTEXT.LIT, the batch file UPGRADE.BAT to upgrade
  45. from 17.2A, LINKLST4.DAT in recompiling with QB 4.5, plus all changes
  46. after 07-30 in code.
  47.  
  48.  
  49. 2.0  Acknowledgments
  50.  
  51. People who contributed code fixes to 17.2B include:
  52.  
  53.                  Randy Sun
  54.                  Mike Zakharoff
  55.                  Robert McAdams
  56.                  Blaine Korcel
  57.                  Ezra Conger
  58.                  Carl Slaughter
  59.                  Kevin Patz
  60.                  Ray Horton
  61.  
  62. Without their help, fixing the problems in 17.2A would have been a
  63. much longer and more difficult process.   The fact that people worked
  64. on fixing the code, with no remuneration, and shared the results with
  65. others, attests both to their generosity and to the wisdom of the policy
  66. of releasing the source code.  RBBS is one of the few products that
  67. accepts no money for the software, releases the source code, and is
  68. "user supported" by volunteers.
  69.  
  70. Many people helped by reporting bugs and beta testing the new version,
  71. and I thank them all collectively.
  72.  
  73.  
  74. 3.0  What Does "Maintenance Release" Mean?
  75.  
  76. A maintenance release means that the changes were made mainly to address
  77. problems in operating RBBS and to eliminate bugs, while minimizing the
  78. probability of introducing new problems.  Maintenance releases
  79. include "merges" to allow upgrading the code from the prior version.
  80.  
  81. Many excellent enhancements were contributed which were not included
  82. in this release, which can be frustrating to their authors.  However,
  83. when the current version has problems, it is generally more important
  84. to make it work properly than to add new features.  Enhancements may be
  85. much more difficult to test and run a significant risk of introducing
  86. new problems, and so their addition was deferred to the next release
  87. (17.3).  For the last 2 and a half years, beta testing of the next
  88. release has begun almost immediately after each new release, and this
  89. pace of development continues unabated with 17.3, with 3 to 4
  90. releases per year.
  91.  
  92. However, the policy of deferring enhancements does not mean that no
  93. enhancements may be added or that only bugs are fixed.  Other types
  94. of changes that may occur in a "maintenance" release are:
  95.  
  96. o   minor changes that affect only a few lines and one type
  97.     of processing, that have a very low probability of introducing
  98.     new problems.
  99.  
  100. Past examples have included shortening strings, make prompts clearer
  101. or more consistent, speeding the code, making a variable name clearer,
  102. consolidating code to reduce the size of the executable program, and 
  103. adding "last (backwards)" as a named constant in message selection.
  104. Changes in 17.2B included clarification of prompts, shortening strings,
  105. removal of inoperative options, allignment of text, and enhancing the
  106. update of the last message read to include attempts to read private
  107. or password protected messages.  In all cases, the design is frozen
  108. some time before the actual release.
  109.  
  110. In some cases, even bug fixes are deferred because the changes necessary
  111. to fix the problem are just too extensive or involve a critical a portion
  112. of the code used for many purposes -- especially when there are other fixes
  113. important to get out more quickly.
  114.  
  115. o   enhancements necessary to fix a problem.
  116.  
  117. 17.2A generalized macros to apply anywhere inside RBBS rather than just
  118. at the main command prompt.   This caused significant problems for
  119. people using macros with short, simple names likely to be typed in
  120. multiple contexts, such as single digits (e.g. for doors), which
  121. therefore got invoked in contexts never intended.  Macros
  122. worked exactly as designed in this regard, but made something no
  123. longer work right that worked fine in earlier versions.
  124.    The solution was to add an enhancement to macros that was 100%
  125. compatible with existing ones, but added a new capability never before
  126. in RBBS - the ability to limit a macro to a specific section or specific
  127. command in a specific section.
  128.  
  129.  
  130. 4.0  How to Upgrade from 17.2A
  131.  
  132. Sysops with no customized changes need only replace CONFIG.EXE and
  133. RBBS-PC.EXE.   There are no changes to any system files.   Be sure
  134. to keep a backup of the old version, in case you run into any new
  135. problems.
  136.  
  137. If you are using macros, you may want to add restraints on where the
  138. macro can be invoked by editing the first line in the macro.   The
  139. format is "<SecLevel>/<where use>", where SecLevel is the minimum
  140. security level to use the macro, and <where use> is the section letter
  141. (M, F, U, or @) optionally followed by a command letter.  For example,
  142. "4/M" means to let callers use the macro who have security level 4 or
  143. higher, and to invoke the macro only when in the main section.
  144. "8/FD" means to limit it to callers with security 8 or more and to only
  145. the File Download command.
  146.  
  147. Persons who have the QuickBasic compiler can download the much smaller
  148. file 172B-MRG.ZIP, apply the merges to produce 17.2B code, and compile
  149. their own version.   Details on this process are inside 172B-MRG.
  150.  
  151. Persons who have customized modifications to RBBS have the most problem
  152. upgrading.   You will probably want to start with the 17.2B code, and
  153. rework you modifications into it.   A good way to do this is to start
  154. with the merges in 172B-MRG so that you can see exactly what has been
  155. changed and mark any changes you want to those same lines, then work
  156. in the changes to the other lines.   The lines modified in 17.2B are
  157. all marked in column 70 or later with a signed and dated change.  The
  158. utility BLED has a file compare function that outputs only the
  159. changes between different versions, which is very useful in comparing
  160. a customized version to a new one.
  161.  
  162.  
  163. 5.0  How to Get Help with RBBS
  164.  
  165. RBBS is as committed to providing full support as well as any commerical
  166. product -- though in a different way.   Rather than a single number
  167. in a single location, RBBS distributes its help in a network of
  168. volunteers.
  169.  
  170. The help available includes
  171.  
  172. o   Written documentation with RBBS.   This is more a reference
  173.     than a guide for novices, however.
  174.  
  175. o   A book, "The Complete Electronic Bulletin Board Starter Kit",
  176.     published by Bantam Books and available at least in Dalton
  177.     Bookstores, which does expertly and patiently explain how to
  178.     set up RBBS, though the version covered is 15.1C.  RBBS remains
  179.     upward compatible with 15.1C and virtually everything in the
  180.     book still applies.
  181.  
  182. o   A commercial product, "RBBS-PC in a Box", which on a CD-Rom disk
  183.     has 7000 shareware and public domain programs stored in compressed
  184.     format and has RBBS virtually pre-installed.  Up 5 minutes after
  185.     you put in the CD-Rom.  For information and ordering contact
  186.     Loren Jones (number below).
  187.  
  188. o   Network mail.   Both RBBS-Net and RelayNet have RBBS support
  189.     conferences.  For RBBS-Net, contract Rod Bowman (number
  190.     below).  For RelayNet contact Greg Snyder (703-323-1782 data
  191.     number).
  192.  
  193. o   Voice support from the authors of RBBS.
  194.  
  195. The authors of RBBS do not get paid for their work and therefore have
  196. other jobs and lives, so time for direct voice support is limited.
  197. But the authors do accepts calls and are willing to help, and can
  198. often give leads to other persons.
  199.  
  200. o   Support Boards
  201.  
  202. Support boards are BBS's where the sysop
  203.  
  204.    o   commits to running RBBS for the foreseeable future
  205.  
  206.    o   has an at least one free, public line
  207.  
  208.    o   is regularly available for helping others
  209.  
  210.    o   makes the latest version of RBBS available, either
  211.        electronically or by mail.
  212.  
  213. Realize that BBS's may cease to exist or no longer have the same
  214. number, and that other commitments may make people unavailable.
  215. But stable boards likely to be running, that have callers
  216. knowledgable about RBBS, and that can link you into a network of
  217. other sysops, include:
  218.  
  219. Arizona.
  220.  
  221.    Tucson.  Gene Lowry.  Bigfoot RBBS.  602-886-7943.
  222.  
  223. California.
  224.  
  225.    Alta Loma.  Rod Bowman.  The PC Spectrum.  714-945-2612.  2 lines.
  226.  
  227.    Concord.  Jon Martin.  Aircomm.   415-689-2090.
  228.  
  229. Connecticut.
  230.  
  231.    Trumbull.  The Second Ring.  Tom Mack.  203-268-5315.
  232.  
  233. Florida.
  234.  
  235.    Tampa.   Dave Hacquebord.  The Sunshine Board.  813-887-3984 and
  236.       813-885-4659.
  237.  
  238. Kentucky.
  239.  
  240.    Lexington.  Ronald Nutter.  Bluegrass RBBS.  606-272-0499.  Fill
  241.       out sysop questionnaire.
  242.  
  243. Illinois.
  244.  
  245.    LaGrange.   Loren Jones.  RBBS-PC of Chicago.  312-352-1035.  After
  246.       November 11, 1989, area code 312 will become 704.
  247.  
  248. Maryland.
  249.  
  250.    Rockville.  Roger Fajman. CPCUG Member's Information Exchange
  251.       (Capital PC Users Group).  301-738-9060.  9 lines.   Join
  252.       Sysop conference.
  253.  
  254. Michigan.
  255.  
  256.    Clinton Towship.  Rick Wadowski.  Clinton MicroLink BBS.  313-263-4680.
  257.  
  258. Pennsylvania.
  259.  
  260.    Sharon Hill (Philadelphia).  Mark Horninger.  Electric Playground.
  261.       215-534-1466.
  262.  
  263. Virgina.
  264.  
  265.    Arlington.  Lee Pollard.  Death Star.  301-839-0705.
  266.  
  267.    Fairfax.  Ken Goosens. Your Place. 703-978-6360.  3 lines.
  268.  
  269.    
  270. o  Help by Topic
  271.  
  272. Ken Goosens maintains an interactive, on-line data base of people who
  273. volunteer to help with RBBS on particular topics.   Again, though,
  274. not every volunteer will always be available.   The list includes:
  275.  
  276.   Topic           Data Number    Last Name    First Name
  277.  
  278. Basic            618-465-0808    SLAUGHTER       CARL         
  279. Batch Files      407-627-6969    AZZARITO        DOUG         
  280. Communication    301-839-0705    POLLARD         LEE          
  281. Compiling        703-978-6360    GOOSENS         KEN          
  282. Conference       417-862-9824    MIDDLETON       WILLIAM      
  283. Conferences      407-627-6969    AZZARITO        DOUG         
  284. Conferences      703-255-1275    DORER           FRANCIS      
  285. Desktop Publish  313-995-2100    MOORE           CORWIN       
  286. Desqview         202/265-4496    MONDALE         ALEX         
  287. Desqview         703-256-4777    KORCEL          BLAINE       
  288. Desqview         703-756-6109    CROCKFORD       MARIANNE     
  289. Desqview         912-432-2440    MULDROW         WARREN       
  290. Doors            201-580-0486    CONGER          EZRA         
  291. Doors            214-790-0754    COLLINS         DARWIN       
  292. Doors            416-783-7094    CASSIDY         JOE          
  293. Doors            503-664-3756    ANSTINE         MITCHELL     
  294. FMS              201-580-0486    CONGER          EZRA         
  295. FMS              301-384-9302    MCGOLDRICK      LARRY        
  296. FMS              407-627-6969    AZZARITO        DOUG         
  297. FMS              416-783-7094    CASSIDY         JOE          
  298. FMS              703-255-1275    DORER           FRANCIS      
  299. FMS              703-978-6360    GOOSENS         KEN          
  300. FMS              912-432-2440    MULDROW         WARREN       
  301. File maint.      703-256-4777    KORCEL          BLAINE       
  302. HST              912-432-2440    MULDROW         WARREN       
  303. MACROS           503-664-3756    ANSTINE         MITCHELL     
  304. Macros           416-783-7094    CASSIDY         JOE          
  305. Macros           703-978-6360    GOOSENS         KEN          
  306. Marcos           202/265-4496    MONDALE         ALEX         
  307. Modems           703-978-6360    GOOSENS         KEN          
  308. Network          301-839-0705    POLLARD         LEE          
  309. Novell Netware   503-664-3756    ANSTINE         MITCHELL     
  310. Novell Netware   703-256-4777    KORCEL          BLAINE       
  311. PC-Slaves        407-627-6969    AZZARITO        DOUG         
  312. PC-Slaves        703-756-6109    CROCKFORD       MARIANNE     
  313. PC-Slaves        703-978-6360    GOOSENS         KEN          
  314. PUI              416-783-7094    CASSIDY         JOE          
  315. PUI              912-432-2440    MULDROW         WARREN       
  316. Pers downloads   703-255-1275    DORER           FRANCIS      
  317. Personal Radio   313-995-2100    MOORE           CORWIN       
  318. Protocols        201-580-0486    CONGER          EZRA         
  319. Protocols        301-839-0705    POLLARD         LEE          
  320. Protocols        703-978-6360    GOOSENS         KEN          
  321. Protocols        912-432-2440    MULDROW         WARREN       
  322. Questionnaires   703-978-6360    GOOSENS         KEN          
  323. Setup            301-384-9302    MCGOLDRICK      LARRY        
  324. Setup            301-870-5963    ISAAC           MICHAEL      
  325. Setup            417-862-9824    MIDDLETON       WILLIAM      
  326. Setup            703-255-1275    DORER           FRANCIS      
  327. Setup            703-756-6109    CROCKFORD       MARIANNE     
  328. Smart Text       407-627-6969    AZZARITO        DOUG         
  329. Subboard         417-862-9824    MIDDLETON       WILLIAM      
  330. Submenus         703-978-6360    GOOSENS         KEN          
  331. Time Lock        407-627-6969    AZZARITO        DOUG         
  332. User Interface   313-995-2100    MOORE           CORWIN       
  333. Utilities        214-790-0754    COLLINS         DARWIN       
  334.  
  335.  
  336. 6.0  The RBBS Committment
  337.  
  338. Most Bulletin Board Software is dedicated to making money for its
  339. authors.   No matter how much the authors love the work, it endures
  340. only so long as the hope of income continues.
  341.  
  342. RBBS is given away for free, and depends not on the flow of money,
  343. but on the continuing dedication and generosity of people who volunteer
  344. to help support and enhance it as a public service, and share their labor
  345. of love with others for the benefit of all.
  346.  
  347. My committment, as a coordinating author of RBBS, is to
  348.  
  349. o    fix any problems, on a priority basis
  350.  
  351. o    steadily refine and enhance RBBS to better serve the needs
  352.      of its users
  353.  
  354. o    help support and coordinate contributions, testing, and releases.
  355.  
  356. RBBS should be bug free, period.  If there is any possible problem with
  357. it, I want to know.   And I want people to use RBBS not because it is free,
  358. but because it is the best.   I am proud of the fact that independent
  359. evaluations of bulletin board software continue to rate RBBS as equal to
  360. or better than packages costing up to $1350, and that RBBS pioneers
  361. innovations which are widely copied in other packages, such as free
  362. downloads, macros, turning the pause when the screen is full into a
  363. rich list of natural options with a resumable listing, and built-in
  364. data base capabilities.
  365.  
  366. Contributions people make to RBBS include improving the documentation,
  367. helping other sysops, sharing menus, macros, and questionnaires, fixing
  368. bugs in the code, developing new enhancements, helping to beta test, and
  369. writing utilities.   The roster of people who have contributed to
  370. RBBS reads like a who's who in microcomputers, nearly all of whom
  371. got started with the help of someone else.  Many of them have gone
  372. on to other things, but their contribution lives on in RBBS though
  373. the support of volunteers, like you, passing on the help they got in
  374. turn to others.
  375.  
  376.      -Ken Goosens
  377.